home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 2.iso / dist / fw_hylafax.idb / usr / freeware / catman / u_man / cat1 / pagesend.Z / pagesend
Text File  |  2002-07-08  |  5KB  |  95 lines
  1. PAGESEND(${MANNUM1_8})               PAGESEND(${MANNUM1_8})
  2.  
  3.  
  4.  
  5. NNAAMMEE
  6.        pagesend    - _H_y_l_a_F_A_X IXO/TAP and UCP transmit program
  7.  
  8. SSYYNNOOPPSSIISS
  9.        $${{LLIIBBEEXXEECC}}//ppaaggeesseenndd [ --ll    ] [ --pp ] [ --cc _c_o_n_f_i_g ] --mm _d_e_v_i_c_e_-
  10.        _I_D _q_f_i_l_e
  11.  
  12. DDEESSCCRRIIPPTTIIOONN
  13.        _p_a_g_e_s_e_n_d    is the program that implements    the  IXO/TAP  and
  14.        the  UCP     transmission  protocol     for  the _H_y_l_a_F_A_X system.
  15.        _p_a_g_e_s_e_n_d    is invoked by the _f_a_x_q scheduler process for each
  16.        pager transmit attempt.    _p_a_g_e_s_e_n_d assumes that its current
  17.        working directory is the    top of the spooling hierarchy and
  18.        that  a    suitable  modem    device has been    allocated for its
  19.        use.  In    normal use _p_a_g_e_s_e_n_d will inherit a  lockfile  for
  20.        the  modem  from     the _f_a_x_q process.  The    format of the job
  21.        description  file  specified  on     the  command    line   is
  22.        described in _s_e_n_d_q(${MANNUM4_5}).
  23.  
  24.        _p_a_g_e_s_e_n_d    initializes the    modem before attempting    to trans
  25.        mit the pager message using the information in the  appro
  26.        priate  modem  configuration  file.  If the modem does not
  27.        respond to this initialization, _p_a_g_e_s_e_n_d     will  repeatedly
  28.        try  to    initialize the modem.  This behaviour is required
  29.        for send-only  environments  in    which  a  _f_a_x_g_e_t_t_y(${MAN
  30.        NUM1_8})     process is not    run (and the modem would be known
  31.        to be in    a properly initialized state).    _p_a_g_e_s_e_n_d  catches
  32.        SIGINT  and  SIGTERM  and  cleans up any    resources it con
  33.        trols; this is the mechanism used by _f_a_x_q to abort  a  job
  34.        while it    is in progress.
  35.  
  36.        Many  aspects of    _p_a_g_e_s_e_n_d operation are controlled through
  37.        a configuration file.  The configuration    file  is  located
  38.        in  the    spooler     hierarchy in the eettcc subdirectory and is
  39.        named  ccoonnffiigg.._d_e_v_i_c_e_-_I_D;;      consult   _h_y_l_a_f_a_x_-_c_o_n_f_i_g(${MAN
  40.        NUM4_5})     for detailed information on the contents of con
  41.        figuration files.
  42.  
  43.        The protocol which must be used    for  a    specific  service
  44.        provider     is controled from the _h_y_l_a_f_a_x_-_i_n_f_o(${MANNUM4_5})
  45.        file.
  46.  
  47. OOPPTTIIOONNSS
  48.        --cc _c_o_n_f_i_g Treat _c_o_n_f_i_g as a configuration parameter speci
  49.          fication  that     is interpreted    after reading the
  50.          per-device  configuration  file.   For     example,
  51.          ``-c  sessiontracing:0x4f''  would  set the SSeess
  52.          ssiioonnTTrraacciinngg configuration parameter to    ``0x4f'',
  53.          overriding  any  setting  in  the  configuration
  54.          file.
  55.  
  56.        --mm _d_e_v_I_D     The device to use in processing the  job.   Note
  57.          that  this  is     a  _d_e_v_i_c_e _i_d_e_n_t_i_f_i_e_r and not the
  58.          pathname of the  tty  special    file.    A  device
  59.          identifier  is     formed    from a device filename by
  60.          removing any leading  ``/dev/''  and  converting
  61.          any ``/'' characters to ``_'' characters.
  62.  
  63.        --ll     Do  the  UUCP lockfile    protocol in _p_a_g_e_s_e_n_d.  By
  64.          default _p_a_g_e_s_e_n_d assumes that it is invoked with
  65.          the  device  already locked and that it does not
  66.          need to manage    the lockfile.
  67.  
  68.        --pp     Do not    change the process priority  when  trans
  69.          mitting.   Normally _p_a_g_e_s_e_n_d will raise its pri
  70.          ority to reduce i/o  latency.     This  option  is
  71.          useful    for debugging.
  72.  
  73. NNOOTTEESS
  74.        _p_a_g_e_s_e_n_d     returns  the  new job status to _f_a_x_q through the
  75.        _e_x_i_t(2) return value of the process: _s_e_n_d___r_e_t_r_y (0), retry
  76.        job;   _s_e_n_d___f_a_i_l_e_d  (1),     job  finished    without     success,
  77.        _s_e_n_d___d_o_n_e (2), job completed  successfully,  _s_e_n_d___r_e_f_o_r_m_a_t
  78.        (3),  job  should be retried after documents are    reformat
  79.        ted.
  80.  
  81. FFIILLEESS
  82.        ${SPOOL}/etc/config.devID     device-specific   configura
  83.        tion file
  84.  
  85.        Consult    _h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MANNUM4_5})  for a complete dis
  86.        cussion of the structure    and content of the spooling area.
  87.  
  88. SSEEEE AALLSSOO
  89.        _f_a_x_q(${MANNUM1_8}), _h_y_l_a_f_a_x_-_s_e_r_v_e_r(${MANNUM4_5}), _h_y_l_a_f_a_x_-
  90.        _c_o_n_f_i_g(${MANNUM4_5}), _h_y_l_a_f_a_x_-_i_n_f_o(${MANNUM4_5})
  91.  
  92.  
  93.  
  94.              October 3, 1995   PAGESEND(${MANNUM1_8})
  95.